(翻译) MongoDB（6） MongoDB 继承 JSON

JSON 所支持的类型仅是 BSON 所支持的一部分(子集). 不仅保留了类型信息, MongoDB 还为 JSON 格式增加了以下扩展:

• 严格模式. BSON 类型的严格模式符合JSON RFC. 任何 JSON 解析器都可以将这些严格模式的表示解析为键/值对; 然而, 仅有 MongoDB 内部 JSON 解析器可以识别由格式所传达的类型信息.

• mongo Shell 模式. MongoDB 内部 JSON 解析器和 mongo shell 都可以解析这个模式.

表现用于各种数据类型决定JSON 解析的上下文.

解析器和支持的格式

严格模式输入

下面可以解析在严格模式下类型信息的识别.

• REST 接口

• mongoimport

• 各种 MongoDB 工具的 --query

其他JSON解析器，包含 mongo shell 和 db.eval(), 可以识别严格模式表示为键/值对, 但是没有识别类型信息.

mongo Shell模式输入

下面可以解析在 mongo shell 模式下识别类型信息.

• REST 接口

• mongoimport

• 各种 MongoDB 工具的 --query

• mongo shell

严格模式输出

mongoexport and REST 和 HTTP 接口 在严格模式下输出数据.

mongo Shell模式输出

bsondump 在 mongo Shell 模式输出.

BSON 数据类型和有关表现

下面介绍 BSON 数据类型和在严格模式和 mongo Shell 模式下有关表现.

二进制

data_binary

Strict Mode	mongo Shell Mode
{ "$binary": "<bindata>", "$type": "<t>" }	BinData ( <t>, <bindata> )

• <bindata> 是一个二进制字符串的base64的表现形式.

• <t> 是单个字节表明数据类型的表现形式. 在严格模式下, 它是一个十六进制字符串, 并且在 Shell 模式它是一个整数. 查阅BSON扩展文档. http://bsonspec.org/spec.html

Date

data_date

严格模式	mongo Shell 模式
{ "$date": "<date>" }	new Date ( <date> )

在严格模式下, <date> 是一种ISO 8601的日期格式, 带着必需的遵循以下格式的(YYYY-MM-DDTHH:mm:ss.mmm<+/-Offset>) 的时区字段.

MongoDB JSON 解析器当前不支持加载 ISO-8601 字符串, 表示Unix纪元之前的日期. 当格式化纪元之前的日期和过去的日期, 你的系统的 time_t 类型可以存在, 使用以下格式:

{ "$date" : { "$numberLong" : "<dateAsMilliseconds>" } }

在 Shell 模式下, <date> 是JSON表示的一个64位有符号整数，赋予了自纪元UTC之后毫秒数.

Timestamp

data_timestamp

严格模式	mongo Shell 模式
{ "$timestamp": { "t": <t>, "i": <i> } }	Timestamp( <t>, <i> )

• <t> 是一个JSON表现的自纪元到现在的32位无符号的总秒数.

• <i> 是一个一直增长的32位无符号整数.

正则表达式

data_regex

严格模式	mongo Shell 模式
{ "$regex": "<sRegex>", "$options": "<sOptions>" }	/<jRegex>/<jOptions>

• <sRegex> 是一个有效的JSON字符串.

• <jRegex> 是一个字符串, 包含有效的JSON字符和非转义的双引号(")字符, 但是可能不包含非转义反斜杠(/)字符.

• <sOptions> 是一个字符串包含使用字母表中的字母来表示正则表达式选项.

• <jOptions> 是一个可能只包含‘g’, ‘i’, ‘m’ and ‘s’等的字符串( 版本1.9新增).

• <jOptions> 是一个可能只包含‘g’, ‘i’, ‘m’ and ‘s’等的字符串( 版本1.9新增). 因为 JavaScript 和 mongo Shell 支持一个范围限制选项, 当转换为这种表示方法的时候，任何不合格的选项都将会被丢弃.

OID

data_oid

严格模式	mongo Shell 模式
{ "$oid": "<id>" }	ObjectId( "<id>" )

<id> 是一个24个字符的16进制字符串.

DB Reference

data_ref

严格模式	mongo Shell 模式
{ "$ref": "<name>", "$id": "<id>" }	DBRef("<name>", "<id>")

• <name> 是一个有效的JSON字符串.

• <id> 是任何有效的扩展JSON类型.

Undefined 类型

data_undefined

严格模式	mongo Shell 模式
{ "$undefined": true }	undefined

JavaScript/BSON undefined 类型的表现.

你不能在文档查询中使用undefined. 想象下面的文档插入到people集合中:

db.people.insert( { name : "Sally", age : undefined } )

下面的查询返回一个错误：

db.people.find( { age : undefined } )
db.people.find( { age : { $gte : undefined } } )

然而，你可以使用$type来查询未定义的值，比如：

db.people.find( { age : { $type : 6 } } )

这个查询返回所有age字段的值为undefined的文档.

MinKey

data_minkey

严格模式	mongo Shell 模式
{ "$minKey": 1 }	MinKey

BSON数据类型 MinKey 的表现是相比之下，小于其它所有类型. 在BSON类型比较排序上查阅比较/排序 顺序的更多信息..

MaxKey

data_maxkey

严格模式	mongo Shell 模式
{ "$maxKey": 1 }	MaxKey

BSON数据类型 MaxKey 的表现是相比之下，大于其它所有类型. 在BSON类型比较排序上查阅比较/排序 顺序的更多信息.

NumberLong

版本2.6新功能。

data_numberlong

严格模式	mongo Shell 模式
{ "$numberLong": "<number>" }	NumberLong( "<number>" )

NumberLong是一个64位有符号整数。你必须包含括号，否则将会被解释为浮点数，导致准确性的损失。

例如，下列命令是把带括号和不带括号的整数值9223372036854775807作为一个NumberLong来插入：

db.json.insert( { longQuoted : NumberLong("9223372036854775807") } )
db.json.insert( { longUnQuoted : NumberLong(9223372036854775807) } )

当你检索文档的时候，未加引号的值已经发生了改变，加引号保证了其的准确性：

db.json.find()
{ "_id" : ObjectId("54ee1f2d33335326d70987df"), "longQuoted" : NumberLong("9223372036854775807") }
{ "_id" : ObjectId("54ee1f7433335326d70987e0"), "longUnquoted" : NumberLong("-9223372036854775808") }

下一章：https://segmentfault.com/a/11...
原文来源：https://docs.mongodb.com/manu...